[index]

InkEffect Property

Syntax: set the inkEffect of <bitmap> to {none | dataSheet | | chartblend | transparent | invert | darker | lighter | add | subtract} Applies to bitmaps (Macintosh only)

Description

The inkEffect property of a dataSheet or bitmap lets you specify how a bitmap is drawn with respect to its background. (If you are a Macintosh developer, you may know ink effects as "transfer modes.") Because the results of the ink effects are determined mathematically, it may be difficult to predict these results unless you understand how colors work on the Macintosh. For an explanation, see the Oracle Media Objects User's Guide.

Notes

The following list specifies each ink effect, its corresponding Macintosh transfer mode, and the result. These ink effects work on a pixel by pixel basis. Note that you can also specify an ink effect using its Macintosh transfer mode name. Ink effect: Transparent Macintosh transfer mode: Transparent What it does: The transparent ink effect compares the colors in the bitmap to the color specified on the inkColor property. It then makes everything in the bitmap that matches the inkColor transparent, so that other objects are visible through those portions of the selected bitmap. Ink effect: Blend Macintosh transfer mode: Blend What it does: Draws the bitmap so that it is a blend of its original color and the color of the background. Blend uses the inkColor property to determine what percentage of the bitmap's color it should combine with what percentage of the background color. The resulting color is actually a combination of that percentage of the bitmap's color and the inverse percentage of the background's color. Ink effect: Add Macintosh transfer mode: Addpin What it does: Creates a new color by adding together the numerical color component values of the bitmap and of the background. You can set a maximum color limit on the resulting color using the inkColor property. So, if the value of the resulting color exceeds that of the inkColor, the result will match the inkColor. Ink effect: Subtract Macintosh transfer mode: Subpin What it does: Creates a new color by subtracting the numerical color component values of the bitmap from that of the background. You can set a minimum color limit on the resulting color using the inkColor property. So, if the value of the resulting color drops below that of the inkColor, the result will match the inkColor Ink effect: Invert Macintosh transfer mode: Notcopy What it does: Creates a new color by subtracting the numerical color component values of the bitmap from that of the background. You can set a minimum color limit on the resulting color using the inkColor property. So, if the value of the resulting color drops below that of the inkColor, the result will match the inkColor